Node / meshtastic / Meshtastic-Android / files / androidApp / src / google / kotlin / org / meshtastic / app / ai / appfunctions / AppFunctionStateSync.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.app.ai.appfunctions

Tff7b72import T7ee787android.content.Context

Tff7b72import T7ee787androidx.appfunctions.AppFunctionException

Tff7b72import T7ee787androidx.appfunctions.AppFunctionManager

Tff7b72import T7ee787androidx.appfunctions.metadata.AppFunctionName

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787kotlinx.coroutines.CancellationException

Tff7b72import T7ee787kotlinx.coroutines.CoroutineScope

Tff7b72import T7ee787kotlinx.coroutines.SupervisorJob

Tff7b72import T7ee787kotlinx.coroutines.delay

Tff7b72import T7ee787kotlinx.coroutines.flow.StateFlow

Tff7b72import T7ee787kotlinx.coroutines.flow.combine

Tff7b72import T7ee787kotlinx.coroutines.flow.launchIn

Tff7b72import T7ee787kotlinx.coroutines.flow.onEach

Tff7b72import T7ee787org.meshtastic.core.di.CoroutineDispatchers

Tff7b72import T7ee787org.meshtastic.core.repository.AppFunctionsPrefs

T8b949e/**

* Observes [AppFunctionsPrefs] and synchronizes the enabled/disabled state of each AppFunction with the system via

* [AppFunctionManager].

*

* When the master toggle is off, all functions are disabled regardless of individual toggles.

*

* Writes are driven by a read-back of the system's own state, so a pass that lands while the functions are still being

* indexed (first launch) converges on a retry instead of leaving the system on its defaults forever.

*/

Tff7b72class T56d364AppFunctionStateSyncTb4b4b4(

Tff7b72private Tff7b72val Te6edf3contextTb4b4b4: Te6edf3ContextTb4b4b4,

Tff7b72private Tff7b72val Te6edf3prefsTb4b4b4: Te6edf3AppFunctionsPrefsTb4b4b4,

Te6edf3dispatchersTb4b4b4: Te6edf3CoroutineDispatchersTb4b4b4,

Tb4b4b4) Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3scope Tff7b72= Te6edf3CoroutineScopeTb4b4b4(Te6edf3SupervisorJobTb4b4b4(Tb4b4b4) Tff7b72+ Te6edf3dispatchersTb4b4b4.Te6edf3defaultTb4b4b4)

Tff7b72init Tb4b4b4{

Te6edf3observeAndSyncTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffobserveAndSyncTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72data Tff7b72class T56d364FunctionToggleTb4b4b4(Tff7b72val Te6edf3idTb4b4b4: Tffa657StringTb4b4b4, Tff7b72val Te6edf3enabledTb4b4b4: Te6edf3StateFlowTff7b72<Tffa657BooleanTff7b72>Tb4b4b4)

Tff7b72val Te6edf3functions Tff7b72=

Te6edf3listOfTb4b4b4(

Te6edf3FunctionToggleTb4b4b4(Te6edf3SEND_MESSAGE_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3sendMessageEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_MESH_STATUS_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getMeshStatusEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_NODE_LIST_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getNodeListEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_CHANNEL_INFO_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getChannelInfoEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_DEVICE_STATUS_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getDeviceStatusEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_NODE_DETAILS_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getNodeDetailsEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_MESH_METRICS_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getMeshMetricsEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_RECENT_MESSAGES_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getRecentMessagesEnabledTb4b4b4)Tb4b4b4,

Te6edf3FunctionToggleTb4b4b4(Te6edf3GET_UNREAD_SUMMARY_IDTb4b4b4, Te6edf3prefsTb4b4b4.Te6edf3getUnreadSummaryEnabledTb4b4b4)Tb4b4b4,

Tb4b4b4)

T8b949e// Combine master toggle with each individual toggle

Te6edf3combineTb4b4b4(Te6edf3prefsTb4b4b4.Te6edf3masterEnabledTb4b4b4, Te6edf3combineTb4b4b4(Te6edf3functionsTb4b4b4.Te6edf3map Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3enabled Tb4b4b4}Tb4b4b4) Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3toListTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4) Tb4b4b4{ Te6edf3masterTb4b4b4, Te6edf3toggles Tff7b72-Tff7b72>

Te6edf3functionsTb4b4b4.Te6edf3mapIndexed Tb4b4b4{ Te6edf3indexTb4b4b4, Te6edf3fn Tff7b72-Tff7b72> Te6edf3fnTb4b4b4.Te6edf3id Te6edf3to Tb4b4b4(Te6edf3master Tff7b72&Tff7b72& Te6edf3togglesTff7b72[Te6edf3indexTff7b72]Tb4b4b4) Tb4b4b4}

Tb4b4b4}

Tb4b4b4.Te6edf3onEach Tb4b4b4{ Te6edf3states Tff7b72-Tff7b72> Te6edf3syncStatesSafelyTb4b4b4(Te6edf3statesTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3launchInTb4b4b4(Te6edf3scopeTb4b4b4)

Tb4b4b4}

T8b949e/** Anything escaping [syncStates] would cancel the collector, leaving sync dead for the process lifetime. */

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffsyncStatesSafelyTb4b4b4(Te6edf3desiredTb4b4b4: Te6edf3ListTff7b72<Te6edf3PairTff7b72<Tffa657StringTb4b4b4, Tffa657BooleanTff7b72>Tff7b72>Tb4b4b4) Tb4b4b4{

Tff7b72try Tb4b4b4{

Te6edf3syncStatesTb4b4b4(Te6edf3desiredTb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3CancellationExceptionTb4b4b4) Tb4b4b4{

Tff7b72throw Te6edf3e

Tb4b4b4} Tff7b72catch Tb4b4b4(Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffTooGenericExceptionCaughtTa5d6ff"Tb4b4b4) Te6edf3eTb4b4b4: Te6edf3ExceptionTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3eTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffAppFunction sync pass failedTa5d6ff" Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffsyncStatesTb4b4b4(Te6edf3desiredTb4b4b4: Te6edf3ListTff7b72<Te6edf3PairTff7b72<Tffa657StringTb4b4b4, Tffa657BooleanTff7b72>Tff7b72>Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3AppFunctionManagerTb4b4b4.Te6edf3getInstanceTb4b4b4(Te6edf3contextTb4b4b4) Tff7b72?: Tff7b72return

Te6edf3repeatTb4b4b4(Te6edf3MAX_SYNC_ATTEMPTSTb4b4b4) Tb4b4b4{ Te6edf3attempt Tff7b72-Tff7b72>

Tff7b72val Te6edf3pending Tff7b72= Te6edf3pendingWritesTb4b4b4(Te6edf3desiredTb4b4b4, Te6edf3readStatesTb4b4b4(Te6edf3managerTb4b4b4, Te6edf3desiredTb4b4b4.Te6edf3map Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3first Tb4b4b4}Tb4b4b4)Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3pendingTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tff7b72return

Tff7b72for Tb4b4b4(Tb4b4b4(Te6edf3functionIdTb4b4b4, Te6edf3enabledTb4b4b4) Tff7b72in Te6edf3pendingTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3state Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3enabledTb4b4b4) Tb4b4b4{

Te6edf3AppFunctionManagerTb4b4b4.Te6edf3APP_FUNCTION_STATE_ENABLED

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3AppFunctionManagerTb4b4b4.Te6edf3APP_FUNCTION_STATE_DISABLED

Tb4b4b4}

Tff7b72try Tb4b4b4{

Te6edf3managerTb4b4b4.Te6edf3setAppFunctionEnabledTb4b4b4(Te6edf3functionIdTb4b4b4, Te6edf3stateTb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3AppFunctionExceptionTb4b4b4) Tb4b4b4{

T8b949e// Usually "not indexed yet" on first launch; the read-back drives the retry.

Te6edf3LoggerTb4b4b4.Te6edf3dTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffAppFunction Tffd700$Te6edf3functionIdTa5d6ff not writable yetTa5d6ff" Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3attempt Tff7b72< Te6edf3MAX_SYNC_ATTEMPTS Tff7b72- T79c0ff1Tb4b4b4) Te6edf3delayTb4b4b4(Te6edf3RETRY_DELAY_MSTb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** System state per function id, or null when it cannot be read — in which case every write is attempted. */

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffreadStatesTb4b4b4(Te6edf3managerTb4b4b4: Te6edf3AppFunctionManagerTb4b4b4, Te6edf3functionIdsTb4b4b4: Te6edf3ListTff7b72<Tffa657StringTff7b72>Tb4b4b4)Tb4b4b4: Te6edf3MapTff7b72<Tffa657StringTb4b4b4, Tffa657BooleanTff7b72>Tff7b72? Tff7b72=

Tff7b72try Tb4b4b4{

Te6edf3managerTb4b4b4.Te6edf3getAppFunctionStatesTb4b4b4(Te6edf3functionIdsTb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3AppFunctionNameTb4b4b4(Te6edf3contextTb4b4b4.Te6edf3packageNameTb4b4b4, Tffa657itTb4b4b4) Tb4b4b4}Tb4b4b4)Tb4b4b4.Te6edf3associate Tb4b4b4{

Tffa657itTb4b4b4.Te6edf3functionNameTb4b4b4.Te6edf3functionIdentifier Te6edf3to Tffa657itTb4b4b4.Te6edf3isEnabled

Tb4b4b4}

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3AppFunctionExceptionTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3dTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffAppFunction states unreadable; writing all togglesTa5d6ff" Tb4b4b4}

Tff7b72null

Tb4b4b4}

Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72const Tff7b72val Te6edf3MAX_SYNC_ATTEMPTS Tff7b72= T79c0ff3

Tff7b72private Tff7b72const Tff7b72val Te6edf3RETRY_DELAY_MS Tff7b72= T79c0ff2Te6edf3_000L

T8b949e/** Toggles whose system state does not already match what prefs ask for. */

Tff7b72internal Tff7b72fun Td2a8ffpendingWritesTb4b4b4(

Te6edf3desiredTb4b4b4: Te6edf3ListTff7b72<Te6edf3PairTff7b72<Tffa657StringTb4b4b4, Tffa657BooleanTff7b72>Tff7b72>Tb4b4b4,

Te6edf3actualTb4b4b4: Te6edf3MapTff7b72<Tffa657StringTb4b4b4, Tffa657BooleanTff7b72>Tff7b72?Tb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3PairTff7b72<Tffa657StringTb4b4b4, Tffa657BooleanTff7b72>Tff7b72> Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3actual Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Te6edf3desired Tff7b72else Te6edf3desiredTb4b4b4.Te6edf3filter Tb4b4b4{ Tb4b4b4(Te6edf3idTb4b4b4, Te6edf3enabledTb4b4b4) Tff7b72-Tff7b72> Te6edf3actualTff7b72[Te6edf3idTff7b72] Tff7b72!Tff7b72= Te6edf3enabled Tb4b4b4}

Tff7b72private Tff7b72const Tff7b72val Te6edf3CLASS_PREFIX Tff7b72= Ta5d6ff"Ta5d6fforg.meshtastic.app.ai.appfunctions.MeshtasticAppFunctions#Ta5d6ff"

Tff7b72const Tff7b72val Te6edf3SEND_MESSAGE_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffsendMessageTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_MESH_STATUS_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetMeshStatusTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_NODE_LIST_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetNodeListTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_CHANNEL_INFO_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetChannelInfoTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_DEVICE_STATUS_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetDeviceStatusTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_NODE_DETAILS_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetNodeDetailsTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_MESH_METRICS_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetMeshMetricsTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_RECENT_MESSAGES_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetRecentMessagesTa5d6ff"

Tff7b72const Tff7b72val Te6edf3GET_UNREAD_SUMMARY_ID Tff7b72= Ta5d6ff"Tffd700${Te6edf3CLASS_PREFIXTffd700}Ta5d6ffgetUnreadSummaryTa5d6ff"

Tb4b4b4}

Tb4b4b4}